using B.S.Data.MES.API.Models;

namespace B.S.Data.MES.API.Services
{
    /// <summary>
    /// 科大讯飞AI服务接口
    /// </summary>
    public interface IXunFeiService
    {
        /// <summary>
        /// 发送聊天请求到科大讯飞API
        /// </summary>
        /// <param name="message">用户消息</param>
        /// <param name="history">对话历史</param>
        /// <returns>AI回复</returns>
        Task<string> ChatAsync(string message, List<ConversationHistory>? history = null);

        /// <summary>
        /// 智能助手对话，集成项目数据查询
        /// </summary>
        /// <param name="request">助手请求</param>
        /// <returns>智能回复</returns>
        Task<AIAssistantResponse> SmartChatAsync(AIAssistantRequest request);

        /// <summary>
        /// 生成鉴权URL
        /// </summary>
        /// <param name="url">原始URL</param>
        /// <returns>鉴权后的URL</returns>
        string GenerateAuthUrl(string url);
    }
}

